home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 2: Applications / Linux Cubed Series 2 - Applications.iso / database / postgres / mpsql-1.0-s / mpsql-1 / mpsql-1.0-static-linux-bin / README < prev   
Encoding:
Text File  |  1996-02-24  |  3.9 KB  |  112 lines

  1. MPSQL - An Interactive Query Tool for Postgres95 
  2.  
  3. This directory contains version 1.0 of MPSQL.
  4.  
  5. The author can be reached via Email: keidav@accessone.com
  6.  
  7. MPSQL is not public domain software.  It is copyrighted by White
  8. River Software but may be used according to the licensing
  9. terms of the the copyright at the end of this document.
  10.  
  11. HISTORY:
  12.  
  13. MPSQL was born out of the need for a usable query tool to help me with
  14. working with Postgres95 while prototyping a database backed WWW application.
  15.  
  16. You will have excuse some of the bad coding practices in this release, while 
  17. trying to write a real app and a tool at the same time something gives ;) 
  18. if any interest in this comes up I will clean things up.  So if you do find 
  19. this useful, please drop me a mail message with your comments! (mail address above)
  20.  
  21. I have only tested this under Linux, but it is generic enough it should compile
  22. under other UNIX systems as well.
  23.  
  24. FEATURES:
  25.  
  26. * execute multiple SQL statements or one of many by highlighting then executing
  27. * work with multiple buffers
  28. * open/save buffers from/to files
  29. * cut/copy/paste between buffers
  30. * spool query output to a file
  31. * spool data in fixed length, comma, tab or space delimited format
  32. * print buffers
  33. * save application options to a startup file ($HOME/.mpsql)
  34.  
  35. REQUIREMENTS:
  36.  
  37. Postgres95 1.0 - libpq
  38. Motif 2.0 - a statically linked binary is available!
  39. libc.so.5+
  40. libdl.so.1.7+
  41. libXxxx.so.6
  42. libXpm.so.4.3
  43.  
  44. INSTALLING:
  45.  
  46. I think the Makefile is pretty straight forward...modify the include and
  47. lib paths as needed and ...
  48.  
  49. make
  50. cp mpsql /usr/bin (or whatever...)
  51. cp Mpsql /usr/X11/lib/X11/app-defaults
  52.  
  53. After copying the above files to your desired locale, start the app and
  54. select the "Connect to DB" option from the "File" menu or the "Connect" button
  55. on the tool bar to logon, an error dialog will come up if unsuccessful or the 
  56. status bar will verify a successful connection with the name of the database.
  57.  
  58. BUGS:
  59.  
  60. I am sure you will find some undocumented "features" ;) and if you do
  61. please fill out the bug.template and mail it to me. Thank-you!!
  62.  
  63. --v.0.9.1
  64.  
  65.     first beta release
  66.  
  67. --v.0.9.2
  68.  
  69.     implemented a more elegent solution to String redef problems with
  70.     <libpq-fe.h> and <X11/Intrinsic.h> , what was I thinking of before %) 
  71.     thanks to Ronald Wahl <Ronald.Wahl@Informatik.TU-Chemnitz.DE> for 
  72.     pointing out the obvious. 
  73.  
  74. --v.1.0.0
  75.     
  76.     command line arguments now supported for: host, port, database and help.
  77.     
  78.     user is now prompted with a file 'Save As' dialog when selecting 'Save'
  79.     for 'Scratch' buffers.
  80.  
  81.     application now grabs keys & buttons while processing a query & displays
  82.     watch cursor while processing query.
  83.  
  84.     support has been added for the postgres 'Copy' commands.
  85.  
  86.     fixed memory leak that occurred when calling DB_Connect().
  87.  
  88.     buffer list is now available as a pulldown menu.
  89.  
  90. TODO:
  91.  
  92. I am considering merging the createdb, createuser, and dump apps into this
  93. application as well.  I will be adding a loader utility similar to Sybase's and
  94. Oracle's loader utilities in the near future.
  95.  
  96. Permission to use, copy, modify, and distribute this software and its
  97. documentation for any purpose, without fee, and without a written agreement
  98. is hereby granted, provided that the above copyright notice and this
  99. paragraph and the following two paragraphs appear in all copies.
  100.  
  101. IN NO EVENT SHALL WHITE RIVER SOFTWARE BE LIABLE TO ANY PARTY FOR
  102. DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING
  103. LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS
  104. DOCUMENTATION, EVEN IF WHITE RIVER SOFTWARE HAS BEEN ADVISED OF THE
  105. POSSIBILITY OF SUCH DAMAGE.
  106.  
  107. WHITE RIVER SOFTWARE SPECIFICALLY DISCLAIMS ANY WARRANTIES,
  108. INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
  109. AND FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
  110. ON AN "AS IS" BASIS, AND WHITE RIVER SOFTWARE HAS NO OBLIGATIONS TO
  111. PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. 
  112.